home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 July / EnigmA AMIGA RUN 29 (1998)(G.R. Edizioni)(IT)[!][issue 1998-07 & 08].iso / earkit / news / thor / docs / thor.faq < prev    next >
Text File  |  1998-05-24  |  18KB  |  430 lines
  1. $Id: thor.faq 1.7 1997/04/06 01:10:50 pettern Exp $
  2.  
  3. =======================================================================
  4.                    THOR Frequently Asked Questions
  5.                        Last updated 1 Apr 1997
  6.  
  7.                             Maintained by:
  8.                   Petter Nilsen (pettern@thule.no)
  9.  
  10.                             Contributors:
  11.                  Kjell Irgens (kjelli@stud.cs.uit.no)
  12. =======================================================================
  13.  
  14. General:
  15. ~~~~~~~~
  16.    1.1  What is this 'system' you talk about all the time?
  17.    1.2  "Failed to load the configuration datafiles."
  18.    1.3  "Systems Config -> Type" is empty.
  19.    1.4  When I quit THOR, it doesn't free all the memory used.  Why?
  20.    1.5  "waitforport" in ARexx scripts fail from within THOR.
  21.    1.6  Multiuser filesystem (MuFS) problems with THOR.
  22.    1.7  Moving the database correctly.
  23.    1.8  Waitpointer is "hanging" after some operation.
  24.    1.9  Adding messages to the database is slow.
  25.    1.10 How to repair broken or damaged message databases.
  26.    1.11 How to snapshot the window positions.
  27.    1.12 XPK/DiskExpander problems
  28.    1.13 Where to get the latest versions of THOR.
  29.    1.14 What is the latest version of THOR?
  30.    1.15 How do I save several messages in a single operation?
  31.    1.16 My list of events doesn't seem to clear.
  32.  
  33. Internet:
  34. ~~~~~~~~~
  35.    2.1  Password is not accepted at a POP host
  36.    2.2  ConnectTHOR still running after being closed with the close
  37.         window gadget.
  38.    2.3  What is socket.library?
  39.    2.4  "Could not open socket.library".
  40.    2.5  "domain name missing.." when sending mail.
  41.    2.6  Error message when trying to select a newsgroup to join.
  42.    2.7  Collecting mail with SMTPd instead of POP3.
  43.    2.8  "Connection refused" when using "Get Mail".
  44.    2.9  How do a send a carbon copy of a mail to several users?
  45.    2.10 How do a get a list of newsgroups from the newsserver?
  46.    2.11 "You must configure e-mail address for the system..."
  47.    2.12 The progressbar total counts down on newscollection.
  48.    2.13 "441 400 No space (spool)" etc. error message
  49.    2.14 Slower getting news/mail on a custom screen whan on WB?
  50.    2.15 My EMail conference claims it's "READ-ONLY", how do I fix that?
  51. -----------------------------------------------------------------------
  52. 1.1 - What is this "system" you talk about all the time?
  53.  
  54. To put it simple, a system is either a particular BBS, an Internet
  55. provider or a Fido site.  You can use THOR to read messages or
  56. postings from many systems.
  57.  
  58. -----------------------------------------------------------------------
  59. 1.2 - "Failed to load the configuration datafiles."
  60.  
  61. 1.  Since the message database is located on disk, it is sensitive to
  62. whatever might happen to the disk.  In case of a disk crash or similar
  63. problem, use one of the commercial or shareware tools that can fix
  64. such problems.  DiskSalv, Quarterback Tools or AmiBack Tools are all
  65. recommended for this purpose.
  66.  
  67. 2.  One or more of the datafiles that THOR needs might be corrupt or
  68. damaged.  Take a backup of your database, then use BaseManager to fix
  69. the problem.  If not even that helps, you may have to delete the
  70. conference (or in the worst case, the whole system and make a new
  71. one).  It might help to copy the .bak file for the reported failed
  72. file over the original.
  73.  
  74. 3. If the IoErr: value is 103, you do not have enough memory to start
  75. THOR. 
  76.  
  77. See also "Repairing a damaged database".
  78.  
  79. -----------------------------------------------------------------------
  80. 1.3 - When I try to configure a new system, the "Type" gadget is empty.
  81.  
  82. THOR isn't installed correctly.  Re-run the installation, reboot and
  83. try again.  If you don't want to install again, you might execute the
  84. cfg* scripts i <YourThorDir>/s/ from shell with the command "execute".
  85.  
  86. -----------------------------------------------------------------------
  87. 1.4 - When I quit THOR, it doesn't free all the memory used.  Why?
  88.  
  89. bbsread.library uses a buffering system.  The buffers will not be
  90. freed immediately by the library.  The library will flush the buffers
  91. after 5 minutes if the library isn't used anymore.  You can flush the
  92. library manually with the "avail flush" command, but AmigaOS will
  93. automatically flush the library from memory when the memory is needed
  94. by some other program if the library is not in use anymore.
  95.  
  96. -----------------------------------------------------------------------
  97. 1.5 - "waitforport" in ARexx scripts fail from within THOR.
  98.  
  99. Associated problems:
  100. THOR does not find programs I start from within THOR, like the
  101. ThorStat program, even if the directory these programs reside in is in
  102. my path.  I have made sure I have the correct path statement in my
  103. user-startup.  What it wrong?
  104.  
  105. Answer:
  106.  
  107. If you have made sure you use the ADD keyword to the path command in
  108. your user-startup and that this directory actually exists, one
  109. possible reason might be that you start THOR as a WB Prosess from
  110. ToolManager.  The WB Startup code in ToolManager is buggy and ignores
  111. any path, so you should start THOR as a CLI prosess from ToolManager
  112. instead (WBStart-handler 1.4 included with ToolManager 2.1a fixes this
  113. problem).  THOR will inherit the path even if started from Workbench
  114. since THOR converts itself to a cli prosess on startup.
  115.  
  116. ParM will show simular (bad) behaviour when started from WB, so start
  117. if from CLI whenever possible.
  118.  
  119. -----------------------------------------------------------------------
  120. 1.6 - Multiuser filesystem problems with THOR.
  121.  
  122. Due to a bug in MultiUsers handling of async lowlevel dos packets, the
  123. files in all THOR's datadirs must be set up without any user or group.
  124. This can be done with the following command:
  125.  
  126. mprotect `getenv thor/bbsdatapath` RWD group RWD other RWD all
  127.  
  128. -----------------------------------------------------------------------
  129. 1.7 - Moving the database correctly.
  130.  
  131. Sometimes  it might be useful to move the THOR installation to another
  132. disk  or  somewhere  else  on  the same disk.  This can be done in the
  133. following fashion:
  134.  
  135. 1. Make sure you are not running THOR and flush the memory with the
  136.    command "avail flush" from a shell.
  137.  
  138. 2. Move the database to wherever you want it.
  139.  
  140. 3. Change envarc:THOR/THORPath to point to the new directory you have 
  141.    THOR in.
  142.  
  143. 4. Change envarc:THOR/BBSReadPath to point to the new directory you
  144.    have you database. The database is usually stored in a "data"-subdir
  145.    under the THOR directory.
  146.  
  147. 5. Reboot.
  148.  
  149. -----------------------------------------------------------------------
  150. 1.8 - Waitpointer is "hanging" after some operation.
  151.  
  152. This can happen with certain commodities that change the mouse pointer
  153. in  various ways.  Particular older programs (eg.  QMouse) is known to
  154. not handle this correctly.  Try running without these programs.
  155.  
  156. -----------------------------------------------------------------------
  157. 1.9 - Adding messages to the database is slow.
  158.  
  159. Several things can be done to speed this up:
  160.  
  161. - Turn off the "Add Users" option on the system in question in Systems
  162.   Config -> Import/Export.
  163.  
  164. - Open  the  user database window and delete all the users you do not
  165.   want in the database. Then select Maintenance in this same window.
  166.  
  167. - Set up more buffers and higher buffer size in Global Config -> 
  168.   Database options. 15 buffers on 15K is a good setting if you can
  169.   afford to use that kind of memory.
  170.  
  171. - If you use XPK packing, turn off "Auto XPK packing" in 
  172.   Global Config -> Database options.
  173.  
  174. -----------------------------------------------------------------------
  175. 1.10 - How to repair broken or damaged message databases.
  176.  
  177. If  you  experience  problems adding messages to the database, reading
  178. messages or other related problems, follow these steps:
  179.  
  180. - Make sure you are not running THOR and flush the memory with the
  181.   command "avail flush" from a shell.
  182.  
  183. - Run the program "basemanager" with the validate switch:
  184.  
  185.   bin/basemanager validate <systemname>
  186.  
  187.   eg. bin/basemanager validate "news&mail"
  188.  
  189. - Use the ARexx script "CheckDatabase.br" with the DELETE switch:
  190.  
  191.   rx rexx/bbsread/checkdatabase.br <systemname> DELETE
  192.  
  193.   eg. rexx/bbsread/checkdatabase.br "news&mail" DELETE
  194.  
  195. - Now, enter the conference with a problem with THOR and make sure
  196.   you have the message list window open. Multiselect (with the shift
  197.   key) all messages with "*BAD DATA*" or "Failed to get message data"
  198.   and then select Delete msgs from the menu.
  199.  
  200. - When you have preformed the steps above, select "pack/purge" on
  201.   this system from within THOR or use the "bin/packbbs" program.
  202.  
  203. -----------------------------------------------------------------------
  204. 1.11 How to snapshot the window positions.
  205.  
  206. Select "Visual Options" from the Configuration menu and then "Save".
  207.  
  208. -----------------------------------------------------------------------
  209. 1.12 XPK/DiskExpander problems
  210.  
  211. - DiskExpander is very buggy and should not be used under any
  212. circumstances until it has been updated.  AFAIK, the authors are
  213. "working" on fixing the known problems with DE.
  214.  
  215. - XPK packing is supported directly in THOR, and this is more
  216. efficient than running THOR on a partition with XPK.  However, there
  217. seem to be problems when using RAKE as compressior, but later NUKE
  218. versions has been tested and works fine.  If you have a problem with
  219. RAKE or any other methods, NUKE is generally a good alternative.
  220.  
  221. -----------------------------------------------------------------------
  222. 1.13 Where to get the latest versions of THOR.
  223.  
  224. The latest versions and fixes can always be found for ftp at
  225. ftp://hstud6.cs.uit.no/pub/thor/ and ftp://thule.icenet.no/pub/thor/,
  226. and on our mirror ftp site at ftp://ftp.demon.co.uk/pub/mirrors/thor/thor/.
  227.  
  228. THOR World Wide Web site: http://www.cs.uit.no/~kjelli/thor.html
  229.  
  230. These sites might contain fixes, ARexx scripts etc. not released on
  231. Aminet.
  232.  
  233. -----------------------------------------------------------------------
  234. 1.14 What is the latest version of THOR?
  235.  
  236. THOR 2.4 is the latest version.
  237.  
  238. -----------------------------------------------------------------------
  239. 1.15 How do I save several messages in a single operation?
  240.  
  241. Open the message list window and select the messages to save with the
  242. mouse while holding the shift key in. Then select save from the menu
  243. and all the selected messages will be saved to the same file.
  244.  
  245. -----------------------------------------------------------------------
  246. 1.16 My list of events doesn't seem to clear.
  247.  
  248. Open the event edit window and check for events with FRZ and ERR in
  249. front of them. When these are gone (eg. deleted), the list will be
  250. cleared the next time you send events from ConnectTHOR.
  251.  
  252. -----------------------------------------------------------------------
  253. 2.1  Password is not accepted at a POP host
  254.  
  255. There are several reasons why a password might be rejected at the POP
  256. host when trying to collect mail:
  257.  
  258. - You are trying to get mail from a server you do not have an account
  259. on.
  260.  
  261. - You have some special characters like *#? etc. in the password. 
  262. Due to the way passwords are sent to GetTCP from ConnectTHOR, some of
  263. these special characters might be interpreted by AmigaDOS and changed.
  264. For instance, if you have a password with a '*' character in, make sure
  265. you pass in an extra '*'. Eg: "pass*word" becomes "pass**word".
  266. **** This problem was fixed in 2.3 of THOR. ****
  267.  
  268. - You have a password longer than 8 characters. Many POP servers do not
  269. accept passwords of more than 8 characters.
  270.  
  271. -----------------------------------------------------------------------
  272. 2.2  ConnectTHOR still running after being closed with the close
  273.      window gadget.
  274.  
  275.  
  276. ConnectTHOR is a commodity and normal behaviour on commodities is to
  277. hide the program and not quit it when using the close gadget in the
  278. window.
  279.  
  280. If you want to quit ConnectTHOR, use the Quit menu item instead.
  281.  
  282. -----------------------------------------------------------------------
  283. 2.3  What is socket.library?
  284.  
  285. socket.library is originally a library included with AS225r2 beta, a
  286. TCP/IP stack made by Commodore but never released to the public.
  287. However, since this is a nice and easy TCP/IP stack and a lot of
  288. developers use it, the THOR TCP programs have been programmed to use
  289. it.  If you use AmiTCP, like most do, you need the socket.library for
  290. AmiTCP that emulates the AS225r2 socket.library in a way that makes
  291. AS225r2 programs work.  This library is included with Grapevine, the
  292. IRC client, and can also be found on ftp://hstud6.cs.uit.no/pub/thor.
  293.  
  294. ***********************************************************************
  295. Starting from THOR 2.3, the TCP modules do not need this library to
  296. work with AmiTCP. 
  297. ***********************************************************************
  298. -----------------------------------------------------------------------
  299.  2.4  "Could not open socket.library".
  300.  
  301. Your socket.library is not installed correctly. Do the following:
  302.  
  303. - Assign inet: to Amitcp:, like this: "Assign inet: amitcp:"
  304. - Create a directory called "libs" in Amitcp: (if it doesn't exist
  305.   already).
  306. - Copy socket.library to Amitcp:libs.
  307. - Setup the SOCKETCONFIG file in envarc:/env: as described in the
  308.   socket.library documentation.
  309.  
  310. -----------------------------------------------------------------------
  311. 2.5  "domain name missing.." when sending mail.
  312.  
  313. Your socket.library is not correctly configured. Create a file in envarc: 
  314. and env:. Here's my file:
  315.  
  316. UID=100 GID=100 USER=pettern DOMAIN=icenet.no UMASK=002
  317.  
  318. Replace the USER with you username, and DOMAIN with your domain,
  319. and it should work fine.
  320.  
  321. -----------------------------------------------------------------------
  322. 2.6  Error message when trying to join a newsgroup.
  323.  
  324. Error message when trying to join a newsgroup:
  325.  
  326.   Failed to load the configuration datafiles.
  327.   Error in dh1:thor/data/bbs0/PassConf.Data.
  328.   Cause: Dos failure
  329.   IoErr reports 103
  330.  
  331. This error messages means that you do not have enough continues memory
  332. to load the large list of newsgroups into memory.
  333.  
  334. -----------------------------------------------------------------------
  335. 2.7  Collecting mail with SMTPd instead of POP3.
  336.  
  337. Some Internet providers do not provide POP3 mail.  Mail needs to me
  338. collected using a SMTP deamon in these cases, and the "Get Mail"
  339. function in ConnectTHOR can not be used.  However, THOR will read
  340. mailboxes created by any SMTPd just fine if you follow these steps:
  341.  
  342. - Set the download directory in Global Config->Paths to the directory
  343. where incoming mail is stored.
  344.  
  345. - Set the Mailpacket name in Systems Config to the name of the mailbox
  346. that is created by SMTPd and save.
  347.  
  348. THOR will now automatically import these mailboxes into its database
  349. when you enter the system configured for Internet.
  350.  
  351. Installation of the SMTP deamon is beyond the scope of this FAQ, see
  352. the supplied documentation for the SMTPd in question for how to do
  353. this.  INetUtils on Aminet includes a SMTPd that will work fine.
  354.  
  355. -----------------------------------------------------------------------
  356. 2.8  "Connection refused" when selecting "Get Mail".
  357.  
  358. See 2.1 and 2.7.
  359.  
  360. -----------------------------------------------------------------------
  361. 2.9  How do a send a carbon copy of a mail to several users?
  362.  
  363. You can send a carbon copy of a mail to several users using one of the
  364. following methods:
  365.  
  366. 1. In the to-address gadget, enter all addresses separated with a ','
  367. (comma).
  368.  
  369. 2. Use the popup gadget to select all the users from a list of users in the
  370. user database.
  371.  
  372. 3. Enter at the very top of the message text a "Cc:" line containing
  373. the addresses of the users to send a carbon copy to. Example:
  374.  
  375. Cc: user1,user2,user3
  376.  
  377. -----------------------------------------------------------------------
  378. 2.10 How do a get a list of newsgroups from the newsserver?
  379.  
  380. Select "Get Conf.List" from the Events menu, then select "Send Events"
  381. in ConnectTHOR and a list of newsgroups will be collected. This might
  382. take some time, so be patient.
  383.  
  384. -----------------------------------------------------------------------
  385. 2.11 "You must configure e-mail address for the system..."
  386.  
  387. If you get this message when sending mail, open the system
  388. configuration from THOR, select the system with the problem, then
  389. select the user info gadget. Enter your full email address in the
  390. email address field and select save. Try again.
  391.  
  392. -----------------------------------------------------------------------
  393. 2.12 The progressbar total counts down on newscollection.
  394.  
  395. You might notice that the total value in the progressbar on getting news
  396. counts down.  This can be of various reasons, but the most normal reason
  397. is that an article is not available anymore on the newsserver due to
  398. cancellation. Another reason can be a short expire of articles on the
  399. server so that you do not have time to collect it before it's being 
  400. deleted.
  401.  
  402. -----------------------------------------------------------------------
  403. 2.13 "441 400 No space (spool)" etc. error message
  404.  
  405. When ConnectThor or SendTCP gives you an error message like this, that
  406. means that your ISP has a full harddisk on their news server.  A good
  407. idea then is to mail or phone them, or just to wait till the next day
  408. and hope that they have fixed it.  All error messages starting with a
  409. number is from the mail or news server.
  410.  
  411. -----------------------------------------------------------------------
  412. 2.14 Slower getting news/mail on a custom screen whan on WB?
  413.  
  414. It doesn't make any difference for THOR if you get news/mail while
  415. running on Thor's screen or any other screen (like Workbench).  If you
  416. notice a big difference in the speed, this is probably caused by DMA
  417. contention.  This means that you are probably using a screenmode that
  418. requires more DMA "time" then on some other screen.  Overscan can
  419. cause this, along with a high number of colours on the screen.
  420.  
  421. -----------------------------------------------------------------------
  422. 2.15 My EMail conference claims it's "READ-ONLY", how do I fix that?
  423.  
  424. Due to a bug in the 2.4 Installer script, the EMail conference was
  425. made READ-ONLY, which is ofcourse wrong.  To fix this, get the
  426. following script from you local Aminet site:
  427.  
  428. FixThorMail.lha    comm/thor     1024 Fix the read-only email problem in Thor
  429.  
  430.